home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / mac / util / develope / istspy03.sit / InstallerSpy 0.30 ƒ / InstallerSpy ReadMe next >
Encoding:
Text File  |  1992-06-13  |  4.7 KB  |  86 lines
  1. InstallerSpy v: 0.30  (6/12/92)
  2. ----------------------------
  3.  
  4. InstallerSpy will decompile scripts for Apple's Installer program.  It can handle scripts compatible with versions 3.1 through 3.3 of the Installer.
  5.  
  6. Currently, all the program does is decompile the script to a textfile.  The output will probably be of no use unless you are already familiar with the installer format, or have a copy of the "Installer 3.x Scripting Guide".  I got mine off a Developer CD.  The decompiled output is *not* backwardly compatible with Rez.  
  7.  
  8. The textfile creator is set to "QED1" by default (for the QUED/M editor).  If you want to change this creator, edit the "SpyP" resource.  The output is best viewed using a mono-spaced font (Monaco or Courier) with word-wrap disabled.
  9.  
  10. When you run InstallerSpy, it will give you a dialog from which you can select which resources you want decompiled and which reports you want to be produced.  When you click "DoIt", you will get a dialog asking you what script to decompile and what to call the output file.
  11.  
  12.  
  13. Easy Install Rule Report
  14. ---------------------
  15. This report decodes both the "infr" (Rule Framework) and "inrl" (Rules) resources in-line.  This allows you to "read" the rules that make up the "Easy Install" option.
  16.  
  17.  
  18. Custom Package Report
  19. ---------------------
  20. This report will display the name of those packages which have their "showOnCustom" flag set.  These are the packages that appear on the "Customize" screen of the installer.  The packages are listed in the order they would appear on the Customize screen.
  21.  
  22. If the "show detail" option is enabled, InstallerSpy will extend the report to include a listing of each atom that is included in each package.  This give you a detailed description of what each package does.
  23.  
  24. Be warned that the "show detail" option can result in a VERY, VERY long report.  Disassembling the Sys7 installer script, with all options enabled, results in a file that is 4.3 MEG (!!) in size.
  25.  
  26. After printing the "showOnCustom" packages, this report will also print all "other" packages.  Usually, these are packages used by the "Custom Install" option.
  27.  
  28. Note, when decompiling several types of atoms, this report will produce some rather cryptic looking output.  For example, when disassembling a "resource atom", you will see something like:  "[rIC TunIsIn]".  This is an attempt to display the "flags" of the resource.  Each letter corresponds to one bit.  For example:
  29.  
  30.     "r" or "R" = don't / do delete when removing
  31.     "i" or "I" = don't / do delete when installing
  32.     "c" or "C" = don't / do copy
  33.  
  34.     "t" or "T" = noTargetRequired; TargetRequired
  35.     "u" or "K" = updateExisting; keepExisting
  36.     ... and so on ...
  37.  
  38. The order of the flags corresponds to the order described in the "Installer Scripting Guide". If you have any questions about just what the flags mean, refer to the "Detailed Info on..." disassembly of the atom.
  39.  
  40.  
  41. The Future?
  42. -----------
  43. I am releasing this preliminary version because there seems to be a large number of people asking for a script decompiler.  I am thinking about adding more features such as:
  44.  
  45. 1) A "summary report" that would look for potential reasons why you would *not* want to bypass the installer, such as: modification of the boot blocks; direct manipulation of the System file; calls to user-defined procedures; etc.
  46.  
  47. 2) An interactive browser so you could view the various resources and jump between them easily.
  48.  
  49. 3) More meaningful, easier to understand descriptions of the various attributes.
  50.  
  51. I'd be interested in hearing your suggestions and priorities.
  52.  
  53. If you find this program useful, have any suggestions, or find any bugs, please drop me a line.  If you have a problem decompiling a script, please send me a copy of the script to one of the addresses below.
  54.  
  55. InstallerSpy is free, but I retain all rights to the program.
  56.  
  57.  
  58. Change History
  59. ************
  60. Version 0.30 (6/12/92)
  61. ---------------------
  62. Ñ Resources are now decompiled in numerical order instead of the order in which they appear in the file.
  63. Ñ Add "Easy Install Rule Report"
  64. Ñ Add "Custom Package Report"
  65. Ñ Display progress indicator during decompile
  66.  
  67. Bug Fixes:
  68. Ñ Fix problem with Word5 script - would crash while decompiling scripts with long "icmt" resources. (AndrÄ)
  69.  
  70. Version 0.20 (5/28/92)
  71. ---------------------
  72. Ñ Externalized textfile creator to "SpyP" resource.  Interim "fix" until I implement a proper preferences dialog
  73. Ñ Added bundle resource, color icon family (thanks to Judd Stiff)
  74. Ñ Print out resource name (if present) of resources being decompiled (Judd)
  75. Ñ Print out more complete header at start of decompile (Judd)
  76.  
  77. Version 0.10 (5/11/92)
  78. ---------------------
  79. Ñ Initial release
  80.  
  81.  
  82. Alex Maluta
  83. CIS: 73457,1767
  84. America Online: ALEXMALUTA
  85. AppleLink: ALEXM
  86.